home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 10 / driver-maker / prdrgn11.arc / PrmFil.doc < prev    next >
Text File  |  1987-01-22  |  10KB  |  249 lines
  1. PrtDrvGen 1.1 / Jørgen Thomsen 870122
  2.  
  3. | Bugs corrected and enhancements in PrtDrvGen V1.1
  4. | =================================================
  5. | 
  6. | 1) The JFY1 (letter space, justify) and JFY2 (word fill, auto center)
  7. |    commands were not executed in V1.1 due to an AmigaDOS peculiarity
  8. |
  9. | 2) The description of parameters available for inclusion with the ^p, ^d,
  10. |    and ^w commands was missing from this file. Additonal information
  11. |    included as well
  12. |
  13. | 3) In case of the driver not being able to get enough memory for its
  14. |    buffers, it will output the string "No mem" to the printer.
  15.  
  16.  
  17. Setting up the parameter file for your brand of printer.
  18. ========================================================
  19.  
  20. In the following we assume that you want to generate a driver for your
  21. printer called MYPRINTER (the name may not contain spaces).
  22.  
  23. 1) Copy NECCP6.dat to MYPRINTER.dat
  24.  
  25. 2) Edit MYPRINTER.dat and change the NEC CP6 specific escape sequences to
  26.    the sequences required for your printer.
  27.    If wanted/needed change also the other parameters specifying the
  28.    operation of the driver.
  29. |  Do NOT add comments in lines with s:
  30. |  Do NOT totally delete any parameters that your printer may not need.
  31. |  PrtDrvGen expects them all to be there (eventually as empty strings
  32. |  in case of string parameters).
  33.  
  34.    Numerical parameters are provided with certain commands. Each parameter
  35.    is a byte, value 0 - 255.
  36.  
  37.    If you specify to the driver generator that an alphanumeric driver
  38.    without graphics should be generated, you will get a very small driver
  39.    with limited functionality e.g. Preferences will not be used for setting
  40.    up the printer, only the escape sequences specified. This may be OK for
  41.    very specific applications or for drivers (e.g. daisy wheel) with
  42.    limited graphical capabilities.
  43.  
  44.    The parameters available for inclusion into the escape sequences in
  45.    case of the full featured driver with the commands ^p, ^d and ^w are
  46.    as follows for the various printer commands:
  47. |  (NOTE. the ^d command can be used for debugging purposes because it
  48. |         will display in decimal notation (3 digits) the binary parameter
  49. |         value referenced by the ^p command).
  50.  
  51.    RIN:
  52.    ----
  53.  
  54.    Parameter 0: Lines per inch
  55.      ---     1: No of lines on one page (Preferences)
  56.      ---     2:      - - - - - -        (computed from form definition)
  57.      ---     3: No of lines to skip at perforation ( - - - - )
  58.      ---     4: Left margin  (Preferences, first column to write, Amiga std.)
  59.      ---     5: Right margin (Preferences,  last column to write,   ----    )
  60.      ---     6: Left  margin - 1 (last column not to write, NEC standard)
  61.      ---     7: Right margin + 1 (first column not to write,    ----    )
  62.  
  63.    All others:
  64.    -----------
  65.  
  66.    Parameters 0 - 7 are the ones provided with the command, if any.
  67.    Additionally the following parameters are available:
  68.  
  69.      IND, NEL, RI:
  70.         Parameter 0: line count before command
  71.            ---    1: line count after command
  72.  
  73.      SFC, SBC:
  74.         Parameter 0: as provided by command
  75.            ---    1: Parameter 0 MOD 10
  76.            ---    2: value from colortable[Parameter 1]
  77.  
  78.      STBM:
  79.         Parameter 0: current no of lines to skip at perforation
  80.            ---    1: current no of lines on page (paper length)
  81.            ---    2: Parameter 1 - Parameter 0
  82.  
  83.      SLPP:
  84.         Parameter 0: current no of lines on page (paper size)
  85.            ---    1: current no of lines to skip at perforation
  86.            ---    2: Parameter 0 - Parameter 1
  87.  
  88.      SLRM, CAM:
  89.         Parameter 0: as provided (CAM: 1)
  90.            ---    1: as provided (CAM: computed)
  91.            ---    2: Parameter 0 - 1
  92.            ---    3: Parameter 1 + 1
  93.  
  94.      PLD, PLU:
  95.         Parameter 0: (length specified in parameter file) * (6 or 8)/8
  96.  
  97.  
  98. | To use this driver for a black and white only printer do the following:
  99. | change "Printer Class" to 1 and "Color Class" to 1. There is no need
  100. | to change the "Sequence for printing colors" parameters.
  101.  
  102. | The colors specified in the SFC and SBC are the printer specific colors
  103. | and will only be used if your program actually uses the SFC and SBC
  104. | commands with an embedded ^p2/^d2/^w2 command.
  105.  
  106. | Inkjet and laser printers will often print one line of dots at a time.
  107. | Most often that would require the "Storage of dots in buffer" parameter
  108. | to be specified as 0 and "No of Raster Rows on each pass" as 1.
  109.  
  110. To clarify the parameters for storing dots in the buffer the following
  111. figure of one pass (line) of a print head is presented:
  112.  
  113.            X ->
  114.         Y  0
  115.         0  :::::::::::::::::::::::::::::::::::
  116.            :::::::::::::::::::::::::::::::::::
  117.            :::::::::::::::::::::::::::::::::::
  118.            :::::::::::::::::::::::::::::::::::
  119.  
  120. The dots may be stored in consecutive bytes as
  121.  
  122.  a) Column by column, left to right
  123.     Byte 1: [(0,0), (0,1), (0,2) .... (0,7)]  Byte 2: [(1,0),  (1,1)...]
  124.  
  125.  b) Column by column, right to left
  126.     Byte 1: [(0,7), (0,6), (0,5) .... (0,0)]  Byte 2: [(1,7),  (1,6)...]
  127.  
  128.  c) Row by row, left to right
  129.     Byte 1: [(0,0), (1,0), (2,0) .... (7,0)]  Byte 2: [(8,0),  (9,0)...]
  130.  
  131.  d) Row by row, right to left
  132.     Byte 1: [(7,0), (6,0), (5,0) .... (0,0)]  Byte 2: [(15,0), (14,0)...]
  133.  
  134.  
  135. | The parameters available for inclusion by the ^p, ^d, and ^w commands when
  136. | writing graphics are the following:
  137. |
  138. |   Parameter "0-1"     Parameter "2-3"
  139. |   [xxxxxxxx xxxxxxxx] [xxxxxxxx xxxxxxxx]
  140. |     ^p0       ^p1         ^p2      ^p3        binary bytes
  141. |     ^d0       ^d1         ^d2      ^d3        3 digit decimal bytes
  142. |     ^w0                   ^w2                 5 digit decimal words
  143. |
  144. |   Parameter "0-1" = ^p0 * 256 + ^p1 = ^w0
  145. |
  146. |   At "Init graphics before/after delay":
  147. |        Parameter "0-1": no of dot columns to receive in each pass (line)
  148. |           ---    "2-3": no of dots in each column
  149. |
  150. |      These strings are output to the printer at the very beginning of
  151. |      the graphics dump. The delay between them allows for a lengthy
  152. |      reset command to finish and the printer to become ready for the
  153. |      following commands if that is needed.
  154. |      This part should be used for initializing the printer with values
  155. |      which are constant throughout the entire graphics dump e.g.
  156. |      unidirectional printing, proper line spacing to avoid white
  157. |      streaks in the picture etc.
  158. |
  159. |   At "Color x prefix" and "Each single buffer terminated by":
  160. |        Parameter "0-1": as above + no of dot columns added to the left
  161. |                         margin in order to center picture
  162. |
  163. |           ---    "2-3": no of bytes actually used for the graphics data
  164. |                         for one pass (line) (size of <data for color x>
  165. |                         below). In case of a 24 pin dot matrix printer
  166. |                         parameter 1 = 24/8 * parameter 0. For an 8 pin
  167. |                         dot matrix printer parameter 1 = parameter 0.
  168. |
  169. |        Make sure, that the dots per inch density you typically will
  170. |        specify to the printer in these prefixes, are in accordance
  171. |        with the "Max dots in X direction" and "Dots pr. inch in X
  172. |        direction" parameters, which AmigaDOS will use for generating
  173. |        the graphics data for the printer.
  174. |
  175. |        A typical prefix would contain:
  176. |         <CR> <select print color> <specify graphics mode and no of
  177. |                                    bytes/columns of data to follow>
  178. |
  179. |      The pass (line) buffer layout is:
  180. |        <color 1 prefix> <data for color 1>
  181. |        <color 2 prefix> <data for color 2>
  182. |        <color 3 prefix> <data for color 3>
  183. |        <color 4 prefix> <data for color 4> <Each s. buf. term. by>
  184. |
  185. |      The contens of the prefixes for the NEC CP6 driver is:
  186. |      <CR> <select print color> <specify graphics mode and how many pin
  187. |      columns of data to follow>
  188. |      
  189. |   At "Finish graphics dump":
  190. |        No parameter values available.
  191. |
  192. |      This string (e.g. a form feed and set printer back to normal text
  193. |      state, if that is needed) is output at the very end of the
  194. |      graphics dump.
  195.  
  196.  
  197.  
  198. Generating the driver.
  199. ======================
  200.  
  201. Make sure, that the files MYPRINTER.dat and PrtDrv.lod are located in the
  202. current directory. The driver generated will be located in the current
  203. directory with the name MYPRINTER.
  204.  
  205. Execute the driver generator PrtDrvGen
  206.  
  207.                PrtDrvGen
  208.  
  209. and respond to the prompt for "Alphanumeric driver without graphics (y/n)"
  210. and "Printer driver name: " (the latter being MYPRINTER).
  211.  
  212. Generating the driver lasts appr. 30 sec. (alphamuneric) or 1.5 minute.
  213. The sizes of the generated drivers when loaded are approx. 1 Kb and 10.5 Kb.
  214.  
  215. To make the driver available for AmigaDOS do the following:
  216.  
  217.     Copy MYPRINTER To DEVS:printers
  218.  
  219. With Preferences do:
  220.  
  221.     AmigaDOS 1.1:
  222.        change the printer to Custom and specify MYPRINTER as Custom Printer
  223.        Name.
  224.        After a warm boot (ctrl-Amiga-Amiga) the driver can be used
  225.  
  226.     AmigaDOS 1.2:
  227.        change the printer to MYPRINTER
  228.  
  229.  
  230. |Using the driver
  231. |================
  232. |
  233. |The AmigaDOS printer device code and the printer specific code (printer
  234. |drivers) will not be loaded into memory until the first output operation
  235. |to the printer is performed. You may experience, that after this load
  236. |nothing happens. This is most likely because the driver could not get
  237. |enough contiguous memory for its buffers.
  238. |
  239. |The code of this driver is due to the added features larger than most
  240. |other drivers, but it will in case of memory shortage reduce its memory
  241. |requirements and execute in a slower mode. If sufficient contiguous memory
  242. |is still not available, it will print the string "No mem" on the printer
  243. |to inform you about this.
  244. |
  245. |You may avoid this by setting margins narrower with Preferences. That will
  246. |produce a smaller picture, but it will reduce the memory requirements.
  247. |You may also choose to print with less density, if your printer supports
  248. |more than a single dots-per-inch mode.
  249.